Release 10.1A: OpenEdge Development:
Progress 4GL Reference

SET-INPUT-SOURCE( ) method

Specifies the source of the XML to be parsed by the SAX-reader.

Return type: LOGICAL

Applies to: SAX-reader object handle

Syntax

SET-INPUT-SOURCE ( mode, { file | memptr | handle | longchar } )

mode

A CHARACTER expression evaluating to “FILE”, “MEMPTR”, “HANDLE”, or “LONGCHAR” indicating whether the XML source is a file, a MEMPTR, a WEB-CONTEXT system handle, or a LONGCHAR variable.

file

A CHARACTER expression that indicates the name of a file. This can be a relative pathname, an absolute pathname, or an HTTP URL.

memptr

A MEMPTR variable that contains the loaded XML text. The size of the MEMPTR variable must match the size of the XML text.

handle

A WEB-CONTEXT system handle. In a WebSpeed application, this directs SAX-reader to get the XML source from WEB-CONTEXT.

longchar

A LONGCHAR variable that contains the loaded XML text. The size of the LONGCHAR variable must match the size of the XML text.

The following checks are not performed by SET-INPUT-SOURCE( ) but are performed by SAX-PARSE( ) at run time:

Whether a file exists and is accessible.
Whether a MEMPTR is usable.
Whether WEB-CONTEXT’s XML attribute is YES.

If WEB-CONTEXT is used outside of a WebSpeed environment, Progress raises a run-time error.